List'r takes the work out of creating listings of the files available on your Hermes BBS. It can operate automatically and/or lists can be created by the SysOp at any time.
List'r catalogs the important information about the files and stores them to locations and filenames of the SysOp's choosing. The information List'r includes in its listings are: filename, uploader, when uploaded, how many times it has been downloaded, the file size, and its short description.
List'r can save a listing of the entire contents of your file sections, or it can save a list based upon a search using variable criteria.
List'r is very useful in maintaining the FILES and NEWFILES lists which are the commonplace among the FidoNet community.
The SysOp can use List'r to view an on-screen report of all files uploaded by any caller. The use of this feature can help determine who your best, and worse transfer section users are. It can also be used to find out what type of files a certain caller may be most interested in.
Feature List
1] Creates listings of files on your BBS by file section.
2] Listings you create are stored to locations and names of your choosing.
3] Saves complete listing of all files on your BBS.
4] Saves listing of files uploaded within the past variable number of days. The number of days you can choose is between 1 and 999. Also saves listing of files which are OLD (have been on your system for many days, but have been downloaded only a few times) and DEAD (have not been downloaded in quite a while).
5] Create lists which include all or a subset of your file areas..
6] Creates on-screen listings of files uploaded by any caller. The SysOp can enter either the caller's name or their user number.
7] Special header and footer messages of up to five (5) lines each can be included in all listings saved to disk. The contents of these messages is configurable by the SysOp.
8] Automatically create lists of recently uploaded files.
9] Remote operation. List'r is configurable either logged on locally or by calling in from remote.
Setting Up List’r
Copy List’r and the List’r Files folder into your Extensions Folder and restart Hermes. Log on as User #1 and select List’r from the Externals List.
Choose “<G> Configure...” from the List’r Menu.
You will now go to the List’r Configure Menu.
Choose “<A> Create Header”
You will be displayed the existing header message and asked if you want to change it. If you respond ‘Y’, you can then type in your new message--one line at a time.
NOTE: Maximum number of characters per line is 78!
Choose “<B> Create Footer”
You will be displayed the existing footer message and asked if you want to change it. If you respond ‘Y’, you can then type in your new message--one line at a time.
NOTE: Maximum number of characters per line is 78!
Choose “<C> Set manual list format”
This allows you to change the format which the disk file is stored in. In this version, you have three choices--TABBED, NORMAL, and NETWORK LIST. The tabbed format saves individual items to one line separated by a tab character. This will be useful for importing into spreadsheets or databases for further processing. The normal format will be used for lists you wish your callers to download. It is a more pleasing visual format than the tabbed. The network list is used when wanting to send file lists in MACFILES or another FidoNet echomail area. This format can also be used if you want to create shorter lists.
NOTE: The network list is specially formatted to work with Tabby. The normal list contains characters which will cause the list to not be sent into the network.
Choose “<D> Set path to ALLFILES”
The full pathname you put in here is where the complete list of files on your BBS will be saved.
Choose “<E> Set path to NEWFILES”
The full pathname you put in here is where the partial list of files–derived from a search for files recently uploaded to your BBS–will be saved.
Choose “<F> Set path to OLDFILES”
The full pathname you put in here is where the partial list of files–derived from a search for files which have been on your BBS a certain number of days, but have been downloaded only a certain number of times or less–will be saved.
Choose “<G> Set path to DEADFILES”
The pathname you enter here will store the list created which contains a list of files which have not been downloaded for a time period you specify.
NOTE: Maximum number of characters for the pathnames is 78!
AutoList - This automatically creates a file list each morning after midnight. Creates the list when no callers are online so as not to disturb their session.
AutoList is especially suited for those BBSs who wish to post their file list in the MACFILES echomail area. The utility “Informant”, by Chris Koch, will automatically post the list to the MACFILES area. A future version of List’r will automatically write the AutoList to the Generic Import and Export files used by Tabby.
Choose “<H> Toggle on/off”
Choosing this command will allow you to turn on or off the AutoList feature. AutoList creates a file, much like the NEWFILE, containing a list of recently uploaded files. When you choose this command, you will told whether the option is on or off and asked if you want to change it. A ‘Yes’ reply toggles the setting.
If you turn AutoList on, you will be asked to enter the number of days to include in the file list.
Choose “<I> Set path”
Allows setting the pathname to where the AutoList will be stored.
UploadList - This automatically creates a file list each morning after midnight. Creates the list when no callers are online so as not to disturb their session.
Choose “<J> Toggle on/off”
Works the same as the AutoList. The Upload List contains a listing of recently uploaded files formatted for display on screen. It includes the uploader’s name, the filename, and the filesize.
NOTE: Upload List is designed specifically to work with the FileControl feature of UserManage’r v1.4 or later, but can be used in other standalone ways.
Choose “<K> Set path”
Allows setting the pathname to where the Upload List will be stored.
Choose “<M> Select File Areas”
This command presents you with a list of all currently active file areas on your BBS. A plus sign (+) indicates that the area will be included in the file lists. A minus sign (-) indicates that the area will not be included in the lists. Simply type the number of the file area to toggle on/off.
Using List’r
From the List’r Sysop Menu:
Choose “<A> Create ALLFILES list
Choosing this will save a list of all files on your BBS to the pathname you entered in the FILES pathname at the Config Menu. The routine that does the work is optimized for quick performance.
Choose “<B> Create NEWFILES list”
Choosing this will save a partial list of files on your BBS to the pathname you entered in the NEWFILES pathname at the Config Menu. You are asked to enter a number representing the number of days back from today. The NEWFILES list will contain only those files which have been uploaded since (and including) that day to today. The routine that does the work is optimized for quick performance.
Choose “<C> Create OLDFILES list”
Choosing this will save a partial list of files on your BBS to the pathname you entered in the OLDFILES pathname at the Config Menu. You are asked to enter a number representing the number of days back from today that a file was uploaded to your BBS. You are then asked to enter a number representing the maximum number of times that a file has been downloaded. The OLDFILES list will contain only those files which have been on your BBS the number of days you entered or more and have been downloaded the number of times you entered or less. The routine that does the work is optimized for quick performance.
Choose “<D> Create DEADFILES list”
Choosing this will save a partial list of files on your BBS to the pathname you entered in the DEADFILES pathname at the Config Menu. You are asked to enter a number representing the number of days back from today that a file was downloaded from your BBS. The DEADFILES list will contain only those files which have not been downloaded since the number of days you entered. The routine that does the work is optimized for quick performance.
NOTE: All file lists should only be created when your BBS has no callers online. The lists can take up to a minute to create and caller’s session will be interrupted during the process.
Choose “<E> Display by uploader's name”
This asks you to enter the name of a caller. Enter the exact name--capitalization counts. It will then go through each transfer directory and display to the screen a listing of the files which that caller has uploaded to your BBS. This routine can be used while a caller is logged on to the BBS.
Choose “<F> Display by uploader's user number”
This asks you to enter the user number of a caller. It will then go through each transfer directory and display to the screen a listing of the files which that caller has uploaded to your BBS. This routine can be used while a caller is logged on to the BBS.
That’s all there is to setting up List’r!
Problems
Any problems should be reported to me either on Currents! (513) 253-2476 or the Hermes Support BBS (213) 275-6975.
Even though Currents! Technologies has reviewed the documentation and tested the software, Currents! Technologies makes no warranty or representation, either express or implied, with respect to this software, its quality, performance, merchantability, or fitness for a particular purpose. As a result, this software is sold ‘as is’, and you, the purchaser, are assuming the entire risk as to its quality and performance. In no event will Currents! Technologies be liable for direct, indirect, special, incidental, or consequential damages resulting from any defect in the software or its documentation. In particular, Currents! Technologies shall have no liability for any damage to programs or data used with Currents! Technologies products including the costs of recovering such programs or data.
The warranty and remedies set forth above are exclusive and in lieu of all others, oral or written, express or implied. No Currents! Technologies dealer, agent, or employee is authorized to make any modification, extension, or addition to this warranty. This warranty gives you specific legal rights, and you may have additional rights which may vary from state to state.
